(C) 1996 AROS - The Amiga Replacement OS


NAME
#include <proto/dos.h>
LONG ReadItem()
SYNOPSIS
STRPTR buffer
LONG maxchars
struct CSource * input

LOCATION
In DOSBase at offset 135
FUNCTION
Read an item from a given character source. Items are words or quoted strings seperated by whitespace or '=' just like on the commandline. The seperator is unread and the read string is terminated by a NUL character.

INPUTS
buffer
Buffer to be filled.
maxchars
Size of the buffer. Must be at least 1 (for the terminator).
input
A ready to use CSource structure or NULL which means "read from the input stream".
RESULT
One of ITEM_UNQUOTED - Normal word read. ITEM_QUOTED - Quoted string read. ITEM_NOTHING - End of line found. Nothing read. ITEM_EQUAL - '=' read. Buffer is empty. ITEM_ERROR - An error happened. IoErr() gives additional information in that case.

NOTES
This function handles conversion of '**', '*"', etc inside quotes.

EXAMPLE
BUGS
SEE ALSO
INTERNALS
HISTORY
27.01.1997 ldp
Polish
09.12.1996 aros
Added empty templates for all missing functions

Moved #include's into first column

24.10.1996 aros
Use the official AROS macros over the __AROS versions.
13.08.1996 digulla
Replaced <dos/dosextens.h> by "dos_intern.h" or added "dos_intern.h" Replaced __AROS_LA by __AROS_LHA
01.08.1996 digulla
Added standard header for all files
28.07.1996 digulla
Initial revision
28.07.1996 digulla
First CVS version of AROS